package com.ruoyi.module.mapper;

import java.util.List;

import org.apache.ibatis.annotations.Param;

import com.ruoyi.module.domain.DictBook;

/**
 * 词典Mapper接口
 * 
 * @author ruoyi
 */
public interface DictBookMapper
{
    /**
     * 查询词典列表
     * 
     * @param dictBook 词典
     * @return 词典集合
     */
    public List<DictBook> selectDictBookList(DictBook dictBook);

    /**
     * 查询词典列表（带标签信息）
     * 
     * @param dictBook 词典
     * @return 词典集合
     */
    public List<DictBook> selectDictBookListWithTags(DictBook dictBook);

    /**
     * 查询用户有权限的词典列表
     * 
     * @param dictBook 词典查询条件
     * @param userId 用户ID
     * @return 词典集合
     */
    public List<DictBook> selectDictBookListByUserId(@Param("dictBook") DictBook dictBook, @Param("userId") Long userId);

    /**
     * 根据语言分类查询词典列表
     * 
     * @param languageCategory 语言分类ID
     * @return 词典集合
     */
    public List<DictBook> selectDictBookListByLanguageCategory(String languageCategory);

    /**
     * 根据ID查询词典
     * 
     * @param id 词典ID
     * @return 词典
     */
    public DictBook selectDictBookById(String id);

    /**
     * 查询所有免费词典
     * 
     * @return 免费词典集合
     */
    public List<DictBook> selectFreeDictBooks();

    /**
     * 查询用户可访问的词典列表（免费词典 + 已授权词典 + 用户自己创建的词典）
     * 
     * @param userId 用户ID
     * @return 词典集合
     */
    public List<DictBook> selectUserAccessibleDictBooks(Long userId);

    /**
     * 新增词典
     * 
     * @param dictBook 词典
     * @return 结果
     */
    public int insertDictBook(DictBook dictBook);

    /**
     * 修改词典
     * 
     * @param dictBook 词典
     * @return 结果
     */
    public int updateDictBook(DictBook dictBook);

    /**
     * 删除词典
     * 
     * @param id 词典ID
     * @return 结果
     */
    public int deleteDictBookById(String id);

    /**
     * 批量删除词典
     * 
     * @param ids 需要删除的数据ID
     * @return 结果
     */
    public int deleteDictBookByIds(String[] ids);
}

